home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 007a / pafabl.zip / PAFABLTY.DOC < prev    next >
Text File  |  1991-06-21  |  25KB  |  676 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                       PAFAbility
  34.  
  35.                                      Version 1.0
  36.  
  37.                                    Fri 21 Jun 1991
  38.  
  39.              (c) Copyright 1991, Barbara A. Bennett. All Rights Reserved.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                    PAFAbility v1.0
  47.           ----------------------------------------------------------------
  48.  
  49.           Contents
  50.           --------
  51.  
  52.           Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   1
  53.  
  54.           Hardware Requirements . . . . . . . . . . . . . . . . . . . .   1
  55.  
  56.           Using PAFAbility  . . . . . . . . . . . . . . . . . . . . . .   1
  57.              WARNING  . . . . . . . . . . . . . . . . . . . . . . . . .   2
  58.              Program options  . . . . . . . . . . . . . . . . . . . . .   2
  59.                Notes  . . . . . . . . . . . . . . . . . . . . . . . . .   2
  60.                Printer  . . . . . . . . . . . . . . . . . . . . . . . .   2
  61.                Single line vs. cascading chart  . . . . . . . . . . . .   3
  62.                Paging . . . . . . . . . . . . . . . . . . . . . . . . .   4
  63.                Reset the printer  . . . . . . . . . . . . . . . . . . .   4
  64.  
  65.           What's it doing?  . . . . . . . . . . . . . . . . . . . . . .   4
  66.  
  67.           Random thoughts on data entry . . . . . . . . . . . . . . . .   5
  68.              FIELD USE  . . . . . . . . . . . . . . . . . . . . . . . .   5
  69.              NAMES  . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  70.              MARRIAGES  . . . . . . . . . . . . . . . . . . . . . . . .   6
  71.              NOTES  . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  72.  
  73.           HOW2READ.TXT file . . . . . . . . . . . . . . . . . . . . . .   7
  74.  
  75.           Problem resolution  . . . . . . . . . . . . . . . . . . . . .   7
  76.  
  77.           PRINTALT program  . . . . . . . . . . . . . . . . . . . . . .   8
  78.  
  79.           Printing the report with a word processor . . . . . . . . . .   9
  80.  
  81.           Printing the report on an unsupported printer . . . . . . . .   9
  82.  
  83.           Liability Statement and Disclaimer  . . . . . . . . . . . . .  10
  84.  
  85.           The Shareware Concept . . . . . . . . . . . . . . . . . . . .  10
  86.  
  87.           Registration  . . . . . . . . . . . . . . . . . . . . . . . .  11
  88.  
  89.  
  90.  
  91.  
  92.           ---------------------------------------------------------------
  93.                                         Page i
  94.  
  95.  
  96.  
  97.  
  98.  
  99.                                    PAFAbility v1.0
  100.           ----------------------------------------------------------------
  101.  
  102.           Introduction
  103.           ------------
  104.  
  105.           PAFAbility is an accessory program for users of Personal
  106.           Ancestral File.  PAFAbility reads the Family Record (FR) data
  107.           files to produce a Record (also known as Modified Register)
  108.           System format descendants report.  The user has the option of
  109.           creating a single line report (listing the descendants of one
  110.           individual) or a multiple line report (listing the descendants of
  111.           each ancestor of a specified individual).
  112.  
  113.           Personal Ancestral File is a registered trademark of the
  114.           Corporation of the President of The Church of Jesus Christ of
  115.           Latter-Day Saints.
  116.  
  117.           Hardware Requirements
  118.           ---------------------
  119.  
  120.           PAFAbility runs on all classes of MS-DOS compatible computers.
  121.  
  122.           If memory above 640K is available, it will be used to hold the
  123.           NAME2.DAT file so that the maximum amount of conventional memory
  124.           is available for the program's use.
  125.  
  126.           The program supports Epson compatible dot matrix printers,
  127.           Hewlett Packard LaserJet compatible printers and provides an
  128.           option for no printer codes to be used.
  129.  
  130.  
  131.           Using PAFAbility
  132.           ----------------
  133.  
  134.           No installation or configuration is required to run this version
  135.           of PAFAbility.  This version of the program assumes that the FR
  136.           data files are in the current DOS directory.  For example,
  137.           suppose the data files you wish to use are in the C:\PAF\BENNETT
  138.           directory and the PAFAbility program is in the C:\PAF\OTHPGMS
  139.           directory.  To execute PAFAbility, you must do the following:
  140.  
  141.           cd\paf\bennett
  142.           \paf\othpgms\pafablty
  143.  
  144.  
  145.           ---------------------------------------------------------------
  146.                                         Page 1
  147.  
  148.  
  149.  
  150.  
  151.  
  152.                                    PAFAbility v1.0
  153.           ----------------------------------------------------------------
  154.  
  155.           WARNING:  This program has the potential to print hundreds of
  156.           pages.  You may wish to capture the report to disk and look at
  157.           the output before sending it to the printer.  PRN2FILE.COM, a
  158.           free utility from PC-Magazine which intercepts printer output, is
  159.           included in the distribution packet.
  160.  
  161.  
  162.           Program options
  163.           ---------------
  164.  
  165.           There are no command line options in this version of the program. 
  166.           After the program loads, it will ask a few questions to gather
  167.           the information needed for the current run.  The answers may be
  168.           entered in upper or lower case.
  169.  
  170.           Notes
  171.           -----
  172.  
  173.           All notes, Fgs notes, No notes?
  174.  
  175.           This question refers to how much text from the NOTES2.DAT file
  176.           should be included in the report. Enter "A" to include all notes
  177.           in the report.  Enter "F" to include only Family Group Sheet
  178.           notes, i.e., those notes which are flagged with "!".  Enter "N"
  179.           to ignore the notes file.
  180.  
  181.           Note: This version of PAFAbility does not print notes that are
  182.           stored in text files. It assumes the notes are in the NOTES2.DAT
  183.           file.
  184.  
  185.           Printer
  186.           -------
  187.  
  188.           Do you want Dot matrix, HP Laser printer, or None?
  189.  
  190.           The answer to this question determines which, if any, printer
  191.           codes are included in the report.  Enter "D" if you have an Epson
  192.           compatible dot matrix computer.  Enter "L" if you are using a
  193.           Hewlett Packard compatible laser printer.  Enter "N" if you have
  194.           an incompatible printer or don't want to include printer codes in
  195.           the report.
  196.  
  197.  
  198.           ---------------------------------------------------------------
  199.                                         Page 2
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                                    PAFAbility v1.0
  206.           ----------------------------------------------------------------
  207.  
  208.           The report is designed for compressed print (17 characters per
  209.           line) with eight lines per inch.
  210.  
  211.           The codes used for the dot matrix printer are:
  212.                ESC SI - to turn on compressed print
  213.                ESC 0  - to turn on 1/8-inch line spacing
  214.                ESC @  - to reset the printer to its normal settings
  215.  
  216.           The codes used for the laser printer are:
  217.                ESC (8U ESC (s0p16.66h8.5v0s0b0T - to select the line
  218.                                                   printer font
  219.                ESC &l8D - to select 1/8-inch line spacing
  220.                ESC E    - to reset the printer to its normal settings
  221.  
  222.  
  223.           If your printer is not compatible with these codes, choose "N"
  224.           for no printer and use PRN2FILE to capture the output to disk.
  225.           Then, set up your word processor program with the correct
  226.           settings, import the report file and print it.
  227.  
  228.  
  229.           Single line vs. cascading chart
  230.           -------------------------------
  231.  
  232.           Do you want a Single line or a Cascading Chart? Enter S or C:
  233.  
  234.           Enter "S" if you want to create a single line report that shows
  235.           the descendants of a specified individual.  Enter "C" if you want
  236.           to create a chart for each end-of-line ancestor for a specified
  237.           individual.
  238.  
  239.           If you enter "S", you will be asked for the RIN of the individual
  240.           whose descendants you want to list.  For example, if I wanted to
  241.           create a report of all descendants of John Bennett, I would enter
  242.           "270" which is his RIN.
  243.  
  244.           If you enter "C", you will be asked for the RIN of the base
  245.           individual to use for the cascading chart. For example, my RIN is
  246.           3. To create a report that contains a descendants chart for each
  247.           of my end-of-line ancestors, I would enter "3" in response to
  248.           this question. If I wanted to create a report of just my father's
  249.           side of the family, I would enter "1" which is his RIN.
  250.  
  251.           ---------------------------------------------------------------
  252.                                         Page 3
  253.  
  254.  
  255.  
  256.  
  257.  
  258.                                    PAFAbility v1.0
  259.           ----------------------------------------------------------------
  260.  
  261.           Paging
  262.           ------
  263.  
  264.           Start each generation on a new page? Enter Y or N:
  265.  
  266.           Enter "Y" if you wish to have a page break between generations.
  267.           This would have the effect of creating a chapter for each
  268.           generation. However, be aware that this can cause a significant
  269.           increase in the number of total pages printed.
  270.  
  271.           Enter "N" if you wish to save paper.
  272.  
  273.           Reset the printer
  274.           -----------------
  275.  
  276.           Reset printer when report is finished? Enter Y or N:
  277.  
  278.           If you are printing directly to the printer and you want the
  279.           normal printer settings restored when the program ends, enter
  280.           "Y".
  281.  
  282.           If you are capturing the report to disk with PRN2FILE or a
  283.           similar program with the intention of printing your report on
  284.           both sides of the paper, enter "N".  If the printer reset code is
  285.           included in the disk report, it will probably cause undesirable
  286.           results when you try to print alternate pages.
  287.  
  288.           What's it doing?
  289.           ----------------
  290.  
  291.           After you've selected the options to be used for the report, the
  292.           program reads the data and writes the report. A page counter
  293.           reporting the progress is displayed on the screen. An index entry
  294.           for each individual named in the report is built and held in
  295.           memory.
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.           ---------------------------------------------------------------
  305.                                         Page 4
  306.  
  307.  
  308.  
  309.  
  310.  
  311.                                    PAFAbility v1.0
  312.           ----------------------------------------------------------------
  313.  
  314.           After all the descendants' information is printed, the index
  315.           entries that were held in memory are reformatted and sorted. The
  316.           message "Sorting index" appears on the screen. If there is not
  317.           enough memory to sort all the names at the same time, temporary
  318.           disk files will be used. If there is not enough free disk space
  319.           for the sort work files, the program will fail. Unfortunately,
  320.           there is no way to calculate how much disk space will be needed.
  321.  
  322.           After the index entries are sorted, the index is printed. A page
  323.           counter reporting the progress is displayed on the screen. If
  324.           nothing went wrong during the sort phase, the program terminates
  325.           with the message "Program successfully completed."
  326.  
  327.  
  328.           Random thoughts on data entry
  329.           -----------------------------
  330.  
  331.           FIELD USE
  332.                The program assumes, as does PAF, that each field contains
  333.                what it was intended to contain. That is, the surname field
  334.                contains a surname; the title field contains a title; etc.
  335.                If you've done as I have and used fields in ways they
  336.                weren't intended - I enter (twin) in the title field to
  337.                indicate multiple births - then the report output may not
  338.                make sense.
  339.  
  340.           NAMES
  341.                This version of the program considers the title to be part
  342.                of the surname when the index entries are sorted. Therefore,
  343.                some names in the index will not appear in the order you
  344.                expect.
  345.  
  346.                Names that don't follow the expected pattern, such as
  347.                "William the Conqueror", will probably not appear in the
  348.                index as one would like. How it will be sorted depends upon
  349.                what was entered in the surname and title fields. I don't
  350.                know of a solution for this problem, since existing versions
  351.                of PAF don't provide well for this type of name.
  352.  
  353.  
  354.  
  355.  
  356.  
  357.           ---------------------------------------------------------------
  358.                                         Page 5
  359.  
  360.  
  361.  
  362.  
  363.  
  364.                                    PAFAbility v1.0
  365.           ----------------------------------------------------------------
  366.  
  367.           MARRIAGES
  368.                PAF assumes that a liason that produces children is a
  369.                marriage. Since PAF provides no way to indicate otherwise,
  370.                that assumption is also used in this program.
  371.  
  372.           NOTES
  373.                I have not always been consistent in the way I entered data
  374.                in the notes file. I quit using the FGS Note indicator back
  375.                when version 2 of PAF was released because I figured I
  376.                always wanted all my notes printed. However, that's not
  377.                appropriate for my purposes with this report. I've decided
  378.                to enter any biographical narrative text as the first FGS
  379.                note(s) for an individual. The next FGS note is: "Sources
  380.                for <individual's name>:". This note is followed by the FGS
  381.                notes containing the source citations for the data. Each
  382.                source citation is followed by the data extracted from that
  383.                source. This data is NOT marked as an FGS note. Here's an
  384.                example:
  385.  
  386.                !John J Arbaugh says: Adam was born on the farm one mile
  387.                north of Jewett, Ohio, owned in 1946 by Ira Arbaugh (gson of
  388.                Adam's brother, John). Adam received a meager education in
  389.                the Orr School. Rev. Benjamin Pope, Lutheran minister
  390.                officiated at his wedding.
  391.  
  392.                !Sources for Adam Arbaugh:
  393.  
  394.                !RESIDENCE-PARENTS:
  395.                   Commemorative Biographical Record, Harrison, Ohio,
  396.                   containing Biographical Sketches of Prominent and
  397.                   Representative Citizens, and of many of the early
  398.                   Settled Families; Chicago: J.H. Beers & Co., 1891;
  399.                   Arbaugh/OH/0001; p. 163, 513.
  400.  
  401.                   "Of the children of John Arbaugh two are living - ... and
  402.                    Adam, in Van Buren County, Iowa."
  403.  
  404.                   "... Adam ..."
  405.  
  406.  
  407.  
  408.  
  409.  
  410.           ---------------------------------------------------------------
  411.                                         Page 6
  412.  
  413.  
  414.  
  415.  
  416.  
  417.                                    PAFAbility v1.0
  418.           ----------------------------------------------------------------
  419.  
  420.                !BIRTH-MARRIAGE-OCCUPATION-RESIDENCE:
  421.                   1885 Iowa State Census; Van Buren County, Iowa; p. 357-8,
  422.                   Family 175, Dwelling 166; Lick Creek Twp, Township 70,
  423.                   Range 10, Section 19; Church of Jesus Christ of Latter
  424.                   Day Saints Family History Library, microfilm #1020187
  425.  
  426.                   Age 62, married, farmer, entitled to vote. Living E side
  427.                   NE 1/4 ??
  428.  
  429.  
  430.           HOW2READ.TXT file
  431.           -----------------
  432.  
  433.           A file named HOW2READ.TXT is included in the PAFAbility
  434.           distribution package. This file is a one-page explanation of how
  435.           to read the report. You may wish to print this file and include
  436.           it with reports that you send to others.
  437.  
  438.  
  439.           Problem resolution
  440.           ------------------
  441.  
  442.           If you have any problems running the program, the most likely
  443.           reason is that there isn't enough memory available for the size
  444.           report you requested. An error message that says "Failed to init
  445.           <something or other>, Status = 8" means that there wasn't enough
  446.           memory. Try making more memory available by removing any TSR
  447.           programs that you have loaded into memory.
  448.  
  449.           I was able to create a report with 3393 subjects and spouses on a
  450.           640K 8088 class machine with 511K available before the program
  451.           was invoked.  The resulting report, which included all notes, was
  452.           1124 pages long; captured to disk, the file was over 4 megabytes.
  453.  
  454.           If you need help, please contact me. The following items will
  455.           help in resolving any problems:
  456.                description of your hardware: class of machine (8088, 80286,
  457.                   etc), amount of memory, printer model, etc
  458.                a screen print showing any error messages
  459.                the options you selected and a copy of your PAF data files
  460.  
  461.  
  462.  
  463.           ---------------------------------------------------------------
  464.                                         Page 7
  465.  
  466.  
  467.  
  468.  
  469.  
  470.                                    PAFAbility v1.0
  471.           ----------------------------------------------------------------
  472.  
  473.           If you find something wrong with the report, please send me the
  474.           following information:
  475.  
  476.                a description of the problem
  477.                a copy of the report page showing the problem
  478.                the option you selected and a copy of your PAF data files
  479.  
  480.           Send the information to:
  481.                Barbara A. Bennett
  482.                6426 Pound Apple Court
  483.                Columbia, MD 21045
  484.  
  485.  
  486.           PRINTALT program
  487.           ----------------
  488.  
  489.           My PAF database currently contains over 6000 individuals. A
  490.           report for my mother's side of the family is about 800 pages. In
  491.           order to save paper, I wanted to print on both sides of the
  492.           paper. None of the public domain or shareware programs I have
  493.           tried have worked successfully for me. So, I wrote a program
  494.           called PRINTALT which is included in the distribution packet.
  495.  
  496.           PRINTALT reads the report file captured by PRN2FILE and prints
  497.           the odd pages. It then prompts the user to turn the paper over
  498.           and prints the even pages.  PRINTALT is what one of my coworkers
  499.           calls a "hurry up quick" or others call "quick & dirty".  It is a
  500.           no frills program and does very little, if any, error trapping. 
  501.           It works for me but I don't guarantee that it will work for you. 
  502.           I would not expect it to work on any file other than the report
  503.           created by PAFAbility.  If you have a printer jam or run out of
  504.           paper on page 500 of a 600 page report, there's no way to
  505.           recover.
  506.  
  507.           If your word processor is capable of printing alternate pages, I
  508.           recommend you use it for this purpose.
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.           ---------------------------------------------------------------
  517.                                         Page 8
  518.  
  519.  
  520.  
  521.  
  522.  
  523.                                    PAFAbility v1.0
  524.           ----------------------------------------------------------------
  525.  
  526.           Printing the report with a word processor
  527.           -----------------------------------------
  528.  
  529.           The report may be captured to disk using PRN2FILE or a similar
  530.           utility.  If you wish to print the report using a word processor,
  531.           you must set the word processor as follows in order to properly
  532.           print the report as formatted:
  533.                17 characters per inch
  534.                8 lines per inch
  535.                0" left and right margins
  536.                0" top and bottom margins
  537.  
  538.           The report is designed for a monospaced font such as Courier. 
  539.           Use of a proportional spaced font will produce unexpected
  540.           results.
  541.  
  542.  
  543.           Printing the report on an unsupported printer
  544.           ---------------------------------------------
  545.  
  546.           If you captured the report to disk and chose "no printer" because
  547.           your printer is not supported by the program, then you must send
  548.           the proper control codes to your printer before attempting to
  549.           print the report.  You must set the printer for 17 characters per
  550.           inch and 8 lines per inch.
  551.  
  552.  
  553.           Using PRN2FILE
  554.           --------------
  555.  
  556.           PRN2FILE intercepts data sent to the printer and writes it to the
  557.           designated disk file.  To send the report to a file named BOOK,
  558.           enter the following command at the DOS prompt before invoking
  559.           PAFAbility:
  560.  
  561.           prn2file book
  562.  
  563.           After PAFAbility has ended, enter the following command to flush
  564.           the last bit of the report to the file and terminate printer
  565.           interception:
  566.  
  567.           prn2file
  568.  
  569.           ---------------------------------------------------------------
  570.                                         Page 9
  571.  
  572.  
  573.  
  574.  
  575.  
  576.                                    PAFAbility v1.0
  577.           ----------------------------------------------------------------
  578.  
  579.           Liability Statement and Disclaimer
  580.           ----------------------------------
  581.  
  582.           The author of this program hereby disclaims all warranties
  583.           relating to this software, whether express or implied, including
  584.           without limitation any implied warranties of merchantability or
  585.           fitness for a particular purpose. The author will not be liable
  586.           for any special, incidental, consequential, indirect or similar
  587.           damages due to loss of data or any other reason, even if the
  588.           authro or an agent of the author has been advised of the
  589.           possibility of such damages. In no event shall the author's
  590.           liability for any damages ever exceed the price paid for the
  591.           license to use software, regardless of the form of the claim. 
  592.           The person using the software bears all risk as to the quality
  593.           and performance of the software.
  594.  
  595.  
  596.           The Shareware Concept
  597.           ---------------------
  598.  
  599.           PAFAbility is distributed as shareware. Shareware is commercial
  600.           software distributed in an unconventional manner.  Microcomputers
  601.           copy information very easily.  Instead of trying to frustrate
  602.           this through copy protection, shareware takes advantage of it to
  603.           reach as many users as possible at the lowest cost. Anyone may
  604.           copy a shareware program and distribute it to whomever they
  605.           desire, provided they do not charge a fee or alter it.
  606.  
  607.           Shareware isn't free.  Serious shareware is as polished as any
  608.           conventional commercial product, and represents just as much
  609.           programming effort.  If you use it regularly, the authors expect
  610.           compensation.
  611.  
  612.           However, unlike conventional distribution, shareware allows you
  613.           to evaluate the product before you decide to purchase it.  The
  614.           price is often lower, as well, because there are no advertising,
  615.           packaging, or distribution costs.
  616.  
  617.           But it can only work with your support.  If you are still using a
  618.           shareware product after a couple of weeks, then it is obviously
  619.           worth something to you, and you should register it.
  620.  
  621.  
  622.           ---------------------------------------------------------------
  623.                                        Page 10
  624.  
  625.  
  626.  
  627.  
  628.  
  629.                                    PAFAbility v1.0
  630.           ----------------------------------------------------------------
  631.  
  632.           Registration
  633.           ------------
  634.  
  635.           To register your copy of PAFAbility, send in a completed copy of
  636.           the enclosed order form (ORDER.FRM) with a check or money order
  637.           for $10.
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.           ---------------------------------------------------------------
  676.                                        Page 11